home *** CD-ROM | disk | FTP | other *** search
/ Best of Shareware / Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso / mac / ZIPPED / DOS / HOME / FPD300.ZIP / FINPART3.TXT < prev   
Text File  |  1992-11-30  |  39KB  |  754 lines

  1.  
  2.  
  3.                      Your Financial Partner
  4.                          Version 3.0CPP
  5.                         December 5, 1992
  6.                (c) 1986 - 1992, Marc R. Feldesman 
  7.                       & Flying Pig Software
  8.                        All Rights Reserved
  9.  
  10.  
  11.      "Your Financial Partner" grew out of frustration with the
  12. complexity and expense of many of today's financial management
  13. programs.  There is nothing in "Your Financial Partner" that an
  14. enterprising user, armed with a solid knowledge of spreadsheet
  15. macro programming, couldn't do in spreadsheets like Lotus 1-2-3,
  16. Quattro Pro, or Excel.  However, "Your Financial Partner" computes
  17. answers to common financial questions in an easy to use format.  My
  18. idea was to produce a simple, menu-driven, self-documenting,
  19. "Shareware" program that would address most of the financial
  20. questions that ordinary people pose.  
  21.  
  22.      Version 3.0CPP represents the first major revision of "Your
  23. Financial Partner" since 1989.  The program was completely
  24. rewritten in C++ and sports a new user interface that makes better
  25. use of color and windows; it also supports a mouse.  New financial
  26. calculations include a substantially expanded set of loan functions
  27. with a handy loan calculator that also doubles as an annuity
  28. calculator, improved loan refinancing and loan acceleration
  29. analysis, enhanced future value functions, and a new set of bond
  30. calculations.  Features present in Version 2.29 and dropped from
  31. 3.0CPP include Net Present Value and Internal Rate of Return
  32. (almost no one used them because they couldn't figure a personal
  33. application where they might be useful), as well as the Calendar
  34. for any month and year (which was an anomaly in a financial
  35. analysis program).  Version 3.0CPP continues to be largely self-
  36. documenting; the manual that follows is intended to supplement the
  37. program and provide information about possible financial
  38. circumstances where specific functions might be useful.
  39.  
  40. Shareware:
  41.  
  42.      "Your Financial Partner" is distributed as "Shareware". 
  43. "Shareware" is a class of software that is made accessible through
  44. various media (local and national bulletin boards, friends,
  45. commercial vendors) on a "try before you buy" basis.  It is not
  46. free software nor is it public domain.  What distinguishes
  47. "Shareware" from "Freeware" is that we "Shareware" authors expect
  48. to be compensated for our work, unlike "Freeware" authors who make
  49. their programs available with no expectation of compensation. 
  50. "Shareware" authors are neither altruists nor fools.  We believe
  51. that the myriad of available software packages (public domain,
  52. freeware, shareware, and commercial) make it nearly impossible to
  53. determine in advance whether a particular package meets your needs. 
  54. With "Shareware" you have the opportunity to "try before you buy." 
  55. A fully functional version of "Your Financial Partner" is thus made
  56. available for your evaluation for a reasonable length of time (30
  57. days).  If, at the end of this 30-day trial period, you find that
  58. it meets your needs, you are expected to register the program by
  59. mailing in the registration form along with the proper registration
  60. fee ($39.95) to the address listed in the back of this manual. If
  61. "Your Financial Partner" does not meet your needs, you are expected
  62. to erase the program from your disks and discontinue using it. 
  63. Whether you register the program or not you are free to share this
  64. program with others provided that the entire program and its
  65. documentation in its original compressed form are  made available.
  66.  
  67. Hardware Requirements:
  68.  
  69.      The program requires an IBM-compatible computer (PC, XT, AT,
  70. 386, or 486) with MS DOS 3.3 or higher, a minimum of 384K of RAM,
  71. and a floppy disk drive.  A printer is optional; however, if you
  72. want hard-copy of any of the program's output, you will need a
  73. printer.  The program makes no special demands on the printer.  Any
  74. 80-column text printer will do.
  75.  
  76.      For those who use Windows as their primary operating system,
  77. "Your Financial Partner" will run as a DOS program under Windows
  78. 3.1.  It runs successfully both in the foreground and in the
  79. background.  It has not been tested with Windows 3.0; however since
  80. it makes no Windows calls, there is no reason why it shouldn't run
  81. under any version of Windows (or OS/2).  
  82.  
  83. Program Installation and Operation:
  84.  
  85.      The program is distributed as a self-extracting archive file
  86. created using the public domain program LHA.  The archive is called
  87. FINPART3.EXE.  While the program will run from a 360K floppy
  88. diskette, both the compressed file and the decompressed executable
  89. program cannot fit on a single 360K floppy diskette.  Therefore, to
  90. extract the executable version of "Your Financial Partner"
  91. (FINPART.EXE) you need to copy FINPART3.EXE to a diskette with a
  92. formatted capacity greater than 360K (i.e. 720K, 1.2MB, or 1.44MB)
  93. or to a hard disk (preferably in its own subdirectory) and type
  94. FINPART3 [enter].  This will cause the extraction routine to unpack
  95. Financial Partner's executable program (FINPART.EXE) and its
  96. documentation.  Once you have unpacked the program, it is ready to
  97. run.
  98.  
  99.      To use "Your Financial Partner,"  you must either be in the
  100. disk directory where the program resides, or you must have the
  101. Financial Partner directory in your directory path.  Once this is
  102. done, you simply type FINPART [enter] from the command line and the
  103. opening credits will appear.
  104.  
  105.      If you wish to use "Your Financial Partner" with a printer,
  106. you need to know that it assumes a printer is attached to LPT1:
  107. (printer port #1).  If you have a printer attached to LPT2:, you
  108. must run the program as follows:
  109.  
  110.           FINPART /2 [enter].  
  111.  
  112. This tells the program to look for a printer attached to LPT2:
  113. rather than LPT1:.
  114.  
  115.      For your information, "Your Financial Partner" opens no files
  116. and does not write anything to a diskette.  If you find a version
  117. that causes your disk drive light to come on after the program is
  118. loaded, you have a bogus copy and you should take suitable
  119. precautions.
  120.  
  121. General Information:
  122.  
  123.      "Your Financial Partner" performs 6 major categories of
  124. financial calculations, plus several useful financial utility
  125. functions.  The main menu displays the general categories.  To move
  126. from choice to choice on the menus, use the up and down arrow keys,
  127. the mouse, or the highlighted letter on the menu item.  When you
  128. are positioned at your choice press the enter key or click the left
  129. mouse button.  This will transfer control to the submenu that
  130. actually contains the associated financial analyses.  If at any
  131. point in the process you wish to return to the main menu, the ESC
  132. key is your path back.
  133.  
  134.      Every function requires user input.  In writing the program I
  135. made every effort to protect you from yourself:  you cannot enter
  136. an implausible or illegal value.  There are two levels of error
  137. trapping.  First, all user-entered input must be numeric. 
  138. Therefore the moment you enter a non-numeric character (except '.'
  139. or '-') the computer will beep and erase your entire entry. 
  140. Second, each input field is validated to ensure that it falls
  141. within the preprogrammed limits.  Thus, for example, you cannot
  142. enter an interest rate larger than 99.99%, or a loan amount greater
  143. than $99999999.99.  Two factors governed these limits (a)
  144. limitations of numeric representation and (b) implausibility of
  145. certain combinations (e.g. 200 year annuity with 3000 payment
  146. periods per year).  The program will not permit you to go to the
  147. next cell until you provide an acceptable entry in the current
  148. cell.  (Note:  the program uses bank years [360 days] for
  149. calculations involving "daily" compounding.  This was a small, but
  150. relatively insignificant, compromise, needed to keep life simpler
  151. for me).
  152.  
  153.      Additional information appears at the bottom of the screen
  154. with every item that requires user input.  This help line is
  155. provided to clarify the entry prompt, and, where relevant, to
  156. detail the range of acceptable values.
  157.  
  158.      Several of the routines require you to choose whether
  159. deposits, withdrawals, or payments occur at the beginning or end of
  160. the period.  Most annuities and loans are paid at the end of the
  161. period; in most savings plans deposits are made at the beginning of
  162. the period.  "Your Financial Partner" allows you to make this
  163. determination for yourself everywhere except loans.  
  164.  
  165.      All routines follow a common path.  When you have finished
  166. entering data and are satisfied with your entries, the results will
  167. appear after you press CTRL-ENTER (the calculation key).  Before
  168. the computer performs the calculations, you are given the option to
  169. print the results to the screen or to the printer. Once you choose
  170. where you want the output to go, the results will appear nearly
  171. instantaneously on the screen, or momentarily at the printer.
  172.  
  173.      Once the output has reached its destination, you will be given
  174. the option to repeat the procedure using different values, or to
  175. return to the main menu.
  176.  
  177.  
  178. Main Menu:
  179.  
  180.      Aside from the "Quit" function, the main menu displays 7
  181. functional choices.  These are:
  182.  
  183.           1. Future Value of Investment
  184.           2. Minimum Savings For Future Value
  185.           3. Withdrawal From an Investment
  186.           4. Present Value of Future Payments
  187.           5. Loan Calculations
  188.           6. Bond Calculations
  189.           7. Utilities
  190.  
  191.  
  192. (1)  Future Value of Investment.
  193.  
  194.      This function has a submenu with 5 different Future Value
  195. calculations.  These include:
  196.  
  197.           1. Future Value Based on Periodic Deposit
  198.           2. Future Value Based on Lump Sum Deposit
  199.           3. Lump Sum Deposit Followed By Periodic Deposit
  200.           4. Periods For PV to Reach FV at Given Interest Rate   
  201.           5. Interest Rate for PV to Grow to FV in N Periods
  202.  
  203.      These functions address the following questions:  If I invest
  204. a certain amount of money (periodically, as a lump sum, or both)
  205. into an account paying a fixed interest rate compounded at regular
  206. intervals, how much money will I accumulate after some interval of
  207. time.  Alternately, it answers the questions of how long it will
  208. take for a sum of money to reach a new value given a particular
  209. interest rate, or what interest rate would be required to achieve
  210. a certain rate of return over a given interval of time.
  211.  
  212.      
  213. (2)  Minimum Savings for Future Value.
  214.  
  215.      This function has 2 items on its submenu.  They are:
  216.  
  217.           1. Regular Deposits Needed For Future Value
  218.           2. Single Deposit Needed For Future Value
  219.  
  220.      This function is devoted to addressing the following problem. 
  221. Suppose you have a 6 year old child who you want to send to college
  222. at age 18.  You haven't started a savings program yet, but you
  223. figure that four years of college will cost about $40,000 twelve
  224. years from now.  Your question is:  How much per month (or any
  225. other period) will I have to put away on a regular basis (or all at
  226. once now) to accumulate $40,000 by the time my child is ready for
  227. college?
  228.  
  229. (3)  Withdrawal from an Investment
  230.  
  231.      There are three items on the submenu for this function.  These
  232. are:
  233.  
  234.           1. Regular Deposits-Regular Withdrawals at Future Date
  235.           2. Lump Sum Deposits. Regular Withdrawals N Years Later
  236.           3. Regular Deposits Needed For Desired Regular Withdrawal
  237.      
  238.      Consider the following problem.  Suppose you are planning to
  239. retire 20 years from now.  On January 1, 1993 you get a pay raise
  240. (or a bonus on December 31, 1992) that you are able to invest. 
  241. Your question is:  if I invest this money on a regular (or lump
  242. sum) basis from now until I retire, how much will I be able to
  243. withdraw on a regular basis when I retire before I run out of
  244. money.  (If you simply want to know how much you'll have after 20
  245. years you can use the Future Value of An Investment function 1.2). 
  246.  
  247.      The first two functions require two input screens each.  The
  248. first screen is needed to calculate how much money will accumulate
  249. before you can start to withdraw it.  The second screen is needed
  250. to determine both the period over which withdrawals will take
  251. place, and the frequency of withdrawals.
  252.  
  253.      The third function approaches the problem in a slightly
  254. different way.  Here your interest is in determining the best way
  255. to obtain a specific amount to withdraw over some period of time. 
  256. This is not useful for perpetuities (i.e. Social Security or a
  257. typical pension plan where withdrawals take place over an
  258. indefinite period of time). 
  259.  
  260.      If you are interested in answering the question of how many
  261. periods will it take to exhaust a particular amount given
  262. withdrawals of a fixed amount at a fixed interest rate, use the
  263. loan calculator (see function 5.1 below).  A loan is a negative
  264. annuity in which the bank loans you money at a specific interest
  265. rate for a fixed period of time, to be paid back (amortized) by
  266. fixed amounts periodically.  Withdrawing money as an annuity is the
  267. same problem as a loan, but in reverse.  In this case you are
  268. loaning the bank money (your nest egg), which they will pay back to
  269. you at a specific interest rate for a fixed period of time. 
  270.  
  271. (4)  Present Value of Future Payments
  272.  
  273.      There are two functions in this submenu.  They are:
  274.  
  275.           1. Lump Sum Future Payment, Present Value
  276.           2. Fixed Series Future Payments, Present Value
  277.  
  278.      Suppose you win the Oregon Lottery.  You might be given the
  279. choice of receiving $200,000 per year for 20 years, or a check now
  280. for $2,000,000.  Which is the better deal?  Most of us won't ever
  281. face this choice; however we might face the following choice:  When
  282. you retire, your pension plan may give you the option of taking
  283. your retirement income as a lump sum, as an annuity for a fixed
  284. length of time, or as a perpetuity.  This pair of functions enables
  285. you to determine the best strategy to the pension problem.  It
  286. computes the Present Value of an Investment that pays a specified
  287. amount in the future, either as a lump sum or as an annuity.  More
  288. specifically, it provides the present value of a lump sum to be
  289. paid at a definite time in the future, or the present value of a
  290. series of payments beginning now and continuing to a definite time
  291. in the future.  (It does not deal with perpetuities).  
  292.  
  293.      By the way, at today's paltry interest rates (say 2.75%) the
  294. present value of $200,000 per year for 20 years is more than $3
  295. million.  In other words, the lottery would have to pay you a lump
  296. sum in excess of $3 million before the lump sum would be a good
  297. deal.  If you thought you could get at least 10% on your
  298. investment, the $2 million lump sum settlement would be a better
  299. deal since the present value of the $200,000 per year for 20 years
  300. at 10% is only $1.7 million.
  301. (5)  Loan Calculations
  302.  
  303.      There are 7 items on the Loan Calculation submenu.  These are:
  304.  
  305.           1. Loan Calculator
  306.           2. Payments for Different Interest Rates - Comparison
  307.           3. Loan Amount for Given Periodic Payment
  308.           4. Amortization Schedule
  309.           5. Current Loan Balance
  310.           6. Accelerated Amortization - Payoff Loan Early
  311.           7. Refinance a Loan
  312.  
  313.      This section is, by far, the most extensive part of "Your
  314. Financial Partner."  Most people at some time in life secure a loan
  315. of one type or another.  These 7 loan functions enable the user to
  316. address almost any loan question imaginable.  
  317.  
  318.      Six pieces of information are needed to render a loan fully. 
  319. These are:  (a) Loan Amount; (b) Nominal Interest Rate; (c) Payment
  320. Frequency; (d) Duration of Loan; (e) Payment Amount (f) Interest
  321. Compounding Frequency.   Of these 6, items (a), (b), (d), and (e)
  322. are free to vary somewhat, while items (c) and (f) are important
  323. but typically constrained by external factors.  The Loan Calculator
  324. (Function 5.1) enables the user to enter any three of the four
  325. freely varying items (a, b, d, e), and the program will
  326. automatically calculate the fourth item.  The Payment Frequency
  327. (item c) cannot be omitted, while the interest compounding
  328. frequency (item f) is, for simplicity, assumed to be the same as
  329. the payment frequency.  Thus, you can enter the Loan Amount, the
  330. Nominal Interest Rate, and desired Payment Amount, and "Your
  331. Financial Partner" will calculate the number of payments required
  332. to fully amortize the loan.  Similarly, you can enter the Loan
  333. Amount, the Loan Duration, and the desired Payment Amount and "Your
  334. Financial Partner" will calculate the interest rate needed to fully
  335. amortize the loan under those conditions.  The Loan Calculator will
  336. compute the missing value in each of the four instances where one
  337. of the four key variables is left out.  If no information is left
  338. out, or if more than one variable is left out, you will encounter
  339. an error message.
  340.  
  341.      As noted above, the Loan Calculator is not limited to use with
  342. loans.  If you understand the relationship between a loan and an
  343. ordinary annuity (a loan is simply a negative ordinary annuity),
  344. the loan calculator can also be used as an annuity calculator. 
  345. Consider, for example, that you have $130,000 in an IRA when you
  346. retire.  The IRA is paying a nominal 6% annum interest.  You have
  347. retired and want to begin withdrawing $1000 per month.  Your
  348. question is how long will the money last?  To use the Loan
  349. Calculator for this question make the $130,000 the Loan Amount,
  350. $1000 per month the payment amount, and 6% the interest rate.  The
  351. missing quantity (Loan Duration) is the value you're looking for. 
  352. This will be calculated when you press the calculate key.  By the
  353. way, the money would last for 17.541 years (210 full months at
  354. $1000 per month, and a final payout of $459).   
  355.  
  356.      Often you are concerned with determining the effect of
  357. interest rate fluctuations on payment amounts.  Function 5.2
  358. provides you with a comparison of payments for a given loan amount
  359. over a range of +-1% (in 0.25% intervals).  
  360.  
  361.      How many times have you wondered how much house you could
  362. afford if you could only manage a 30-year mortgage with $750 per
  363. month in principal and interest payments?  What happens to the
  364. affordability of a home if interest rates change?  Function 5.3
  365. provides the you with a comparison of Loan Amounts for a fixed
  366. periodic payment at interest rates over a range of +-1% (in 0.25%
  367. intervals).
  368.  
  369.      Function 5.4, the Amortization Schedule, provides a full
  370. payment schedule for any loan.  It reports the amount of every
  371. payment apportioning the proper amounts to principal reduction and
  372. to interest, and provides a running loan balance after each payment
  373. is made.  [You should beware that the outstanding balances
  374. calculated after any specific payment may differ from the actual
  375. outstanding balance reported by your bank.  "Your Financial
  376. Partner" assumes that you make your payments at exactly equal
  377. intervals.  Your bank computes interest charges daily and
  378. calculates your balance based on the exact number of days that
  379. elapse between each periodic payment.]
  380.  
  381.      Function 5.5 calculates the outstanding balance on a loan
  382. after any given periodic payment has been made.  There is nothing
  383. in Function 5.5 that can't be obtained from the full amortization
  384. schedule (Function 5.4); however users may simply wish a quick loan
  385. balance without going through the trouble of a full amortization
  386. schedule.  
  387.  
  388.      Suppose you have a home loan at 8.5% interest that has 20
  389. years before it is fully amortized (paid off).  You are due to
  390. retire in 12 years and you would like to pay the loan off by the
  391. time you retire.  What is the best way to do this?  How much money
  392. will you save over the long run by doing so?  Aside from writing a
  393. check today for the balance due, there are really only three ways
  394. to accelerate the payoff of the loan.  The first is to increase
  395. your monthly payments by some fixed amount and to apply the extra
  396. amount to principal reduction.  The second way is to take a single
  397. lump sum of cash and directly reduce the principal.  The third is
  398. to make an extra payment every year.  [I am aware of the strategy
  399. of dividing a monthly payment into two equal fractions and sending
  400. that fraction to the bank every two weeks.  This results in 26
  401. biweekly payments.  I surveyed 18 banks and mortgage companies in
  402. the Portland area.  None would permit a mortgagor to submit
  403. fractional payments as this strategy requires.  Therefore, I did
  404. not include this option in "Your Financial Partner".  However, you
  405. should understand that the biweekly option is basically the same as
  406. submitting 13 monthly payments annually, with the entire extra
  407. payment applied to principal reduction.  This latter strategy is
  408. offered as an option in "Your Financial Partner."  All of the banks
  409. I contacted were more than willing to accept an extra payment
  410. submitted this way.]  
  411.  
  412.      Function 5.6 is offered for the user to consider the different
  413. approaches to accelerating the payoff of a loan.  The procedure
  414. used in "Your Financial Partner" for dealing with the first two
  415. acceleration techniques is straightforward and requires no
  416. explanation.  I had to impose some constraints to simplify the
  417. calculations for the third option.  "Your Financial Partner"
  418. assumes that you want the first extra payment applied immediately,
  419. and then subsequent extra payments would be applied after a full
  420. year has elapsed between each extra payment.  Thus on a loan with
  421. monthly payments the first extra monthly payment would be applied
  422. with the next payment due and subsequent extra payments would be
  423. added every 12th payment thereafter.  For a weekly loan the
  424. interval would be 52 weeks, etc.
  425.  
  426.      This function reports the total amount paid under normal
  427. amortization and under accelerated amortization, as well as
  428. providing both the dollar savings and reduction in loan term
  429. resulting from acceleration.  
  430.  
  431.      Loan function 5.7 enables you to explore the nether world of
  432. loan refinancing.  With today's volatile interest rates, virtually
  433. all of us have considered refinancing loans initially obtained at
  434. rates significantly higher than those presently available.  The
  435. goal in refinancing usually is to lower the monthly payment, to
  436. lower the total amount of interest paid over the life a loan, or
  437. both.  There are times when refinancing is not economically prudent
  438. (this is particularly true when loan fees and points are high and
  439. the differential between the refinancing interest rate and the
  440. original interest rate is relatively small).  Function 5.7 takes
  441. all of the relevant variables into consideration:  current interest
  442. rate, current loan term, existing balance, current monthly payment,
  443. proposed interest rate, proposed loan term, new monthly payment,
  444. and new loan fees and points.  These variables are combined to
  445. produce a comparison of what the net periodic savings will be under
  446. the new loan terms, what the gross savings will be over the life of
  447. the loan taking into consideration the effect of new loan fees and
  448. points if applicable, and will calculate the length of time needed
  449. to payback the loan fees and points given the reduced monthly
  450. payments.  Typically it is this combination of information that
  451. allows you to make a more informed decision about refinancing.  You
  452. should remember that "Your Financial Partner" does not take into
  453. account the fees and points you might have paid to secure the
  454. original loan.  These fees should be subtracted from the GROSS
  455. savings to get a NET savings under refinancing.    
  456.  
  457. (6)  Bond Calculations:
  458.  
  459.      Relatively few of us will ever purchase corporate or municipal
  460. bonds.  Nevertheless, mutual funds have become a very popular
  461. investment for the average investor.  A large number of low- to
  462. medium-risk mutual funds invest part of their resources in
  463. municipal and/or corporate bonds.  Therefore, understanding the way
  464. in which bond prices and bond values are affected by market factors
  465. may provide some insight into the price ebb and flow of mutual
  466. funds that invest in them.  
  467.  
  468.      The functions grouped under Bond Calculations include:
  469.  
  470.                1.   Bond Valuation
  471.                2.   Bond Yield to Call
  472.                3.   Bond Yield to Maturity
  473.  
  474.      Bonds are issued at a face value (called the par value) with
  475. a coupon interest rate (the annual rate of interest paid on the
  476. bond), and a term of issue (the length of time until the bond
  477. matures and is redeemed by the issuer).  Bonds can be purchased
  478. when they are issued, but also at any time after issue and before
  479. maturity.  The value of the bond changes over time in response to
  480. two factors:  market interest rates and time remaining until
  481. maturity.  If you buy a bond at issue, you will buy it for its face
  482. value.  Each year you will receive an interest check computed to be
  483. the bond face value times the coupon interest rate.  Thus a $1000
  484. bond, issued for 30 years, paying a coupon interest rate of 10%
  485. annually will yield $100 per year for 30 years.  At the end of 30
  486. years (the bond maturity date) the bond issuer will redeem the bond
  487. for $1000.  If market interest rates do not fluctuate during the 30
  488. years, the bond will have yielded a 10% return and its value will
  489. have held constant.  If market interest rates do fluctuate, the
  490. bond's value will change over time.  If market interest rates go
  491. down, the bond's value will increase and it is sold as a premium
  492. bond.  The reason is simple.  New bonds issued at that time will
  493. carry a lower coupon interest rate which yields a lower annual
  494. interest payment and a lower overall yield at maturity.  Naturally
  495. investors would be willing to pay more for a bond if they could get
  496. a higher interest rate and a higher annual interest payment; thus,
  497. your bond's value is set to be that where its yield at maturity
  498. equals that of the currently available (lower yielding) bond.  This
  499. means that the bond will have to be purchased for more than its
  500. face value.  On the other hand, if market interest rates are higher
  501. than the bond rates, people will try to sell off the bonds and move
  502. money into higher yielding investments.  This will, in turn, cause
  503. the bond to be sold at a discount, with the price being set to that
  504. where its yield at maturity also equals that of the currently
  505. available (higher yielding) bonds.
  506.  
  507.      Function 6.1 computes the current value of a bond at any time
  508. between issue date and maturity.  It does so by taking into account
  509. the difference in coupon interest rates and current interest rates. 
  510. If you experiment with function 6.1 you will see that there really
  511. is an inverse relationship between market interest rates, coupon
  512. interest rates, and bond value.
  513.  
  514.      If, after a bond is issued, market interest rates drop
  515. substantially, the bond issuer may want to redeem the bond early
  516. and reissue new bonds to take advantage of the lower market
  517. interest rates.  They can do so only if the bond has call
  518. provisions.  A call provision is a condition specified in the bond
  519. that allows its issuer to redeem the bond early for any reason
  520. provided certain temporal conditions hold (e.g. more than 5 years
  521. has elapsed since the bond was issued).  Typically bonds are called
  522. only if market interest rates have fallen significantly.  Bonds
  523. that are called generally yield a lower overall return on
  524. investment than bonds held to maturity.  Issuers usually establish
  525. a formula to determine how to set the price of a bond at call.  For
  526. example, some bonds have call provisions that set the call price
  527. as:  bond par value x (100% + current market interest rate)N where
  528. N is the number of years that have elapsed since the bond was
  529. issued.  In any case, the call price is uniquely determined for
  530. every bond and can be easily calculated.  Function 6.2 will enable
  531. you to determine the yield of a bond that has been called after N
  532. years, given current market interest rates and a known call price.
  533.  
  534.      Finally, if you buy a bond at its original issue (at its par
  535. or face value) and hold it to maturity, the yield on the bond is
  536. the same as its coupon interest rate.  On the other hand, bonds
  537. purchased after their initial issuance are rarely purchased at par
  538. value.  Thus, if these bonds are held to maturity they will yield
  539. more or less than the coupon interest rate.  Bonds purchased for
  540. less than par value (discount bonds) and held to maturity yield
  541. more than the coupon interest rate.  This makes sense because the
  542. bond will return not only the fixed interest payment every year but
  543. will also pay the bond's par value at maturity.  Thus, the addition
  544. of a capital gain (the profit from redeeming the bond for more than
  545. its purchase price) to the annual coupon interest produces a yield
  546. to maturity higher than the coupon rate.  By contrast, the opposite
  547. condition obtains when bonds are purchased for more than par value
  548. (premium bonds) and held to maturity.  Here there is a capital loss
  549. at maturity when the bond is redeemed for a lower price than that
  550. for which it was purchased.  This loss reduces the yield to
  551. maturity below the coupon interest rate.  Function 6.3 calculates
  552. bond yield to maturity by factoring in purchase price versus the
  553. bond's par value and length of time to maturity.
  554.  
  555.  
  556. (7)  Utilities
  557.  
  558.      Three different financial utilities are offered in "Your
  559. Financial Partner."  They are:
  560.  
  561.                1.   Effective Interest Rate
  562.                2.   Taxable Interest Rate
  563.                3.   Days Between Dates
  564.  
  565.      Suppose you want to put money into a savings account at a
  566. local bank.  There are three banks nearby that each pay 5% annual
  567. interest.  Bank 1 compounds the interest quarterly, Bank 2
  568. compounds monthly, and Bank 3 compounds daily.  If all other
  569. services offered are equal, into which bank should you put your
  570. money to maximize your yield?
  571.  
  572.      Function 7.1 calculates the effective interest rate and
  573. provides you with the answer.  Bank 1, paying a nominal interest
  574. rate of 5% per annum compounded quarterly, is actually paying an
  575. effective interest rate of 5.09%; Bank 2, which pays 5% compounded
  576. monthly, is actually paying an effective rate of 5.12%; and Bank 3,
  577. which compounds daily, provides an effective yield of 5.13%.  Thus,
  578. Bank 3 should get your money.  In general, the more often interest
  579. is compounded the higher the effective interest rate.
  580.  
  581.      The financial section of today's newspaper is littered with
  582. advertisements offering a variety of investments.  Suppose you have
  583. $1000 to invest.  You want something relatively safe, yet something
  584. that provides a higher return than an ordinary passbook savings
  585. account.  You are given two possible investments that meet your
  586. objectives to provide a safe, modest rate of return.  The first of
  587. these invests in short-term corporate bonds and has consistently
  588. returned about 7.5%.  The second of these invests in a variety of
  589. tax-free municipal bonds and has consistently returned about 6%. 
  590. Other things being equal, which of the two investments should you
  591. choose?  
  592.  
  593.      The key element in investing is recognizing that some
  594. investments generate gains that are completely free of taxes, while
  595. others yield profits that are subject to ordinary income tax.  To
  596. compare any two investments fairly, we need to level the playing
  597. field.  Function 7.2 provides the necessary levelling.  
  598.  
  599.      Whenever we make money from our investments, our earnings are
  600. subject to income tax unless the earnings are tax-free.  Most
  601. investors will find themselves in either the 28% or 31% federal
  602. marginal tax bracket.  In addition, many states also tax profits
  603. from investments.  Suppose our hypothetical investor above was
  604. paying federal tax at the 31% marginal rate, and state tax at a 9%
  605. marginal rate.  This means that the earnings are reduced by 31%
  606. because of federal tax, and 9% because of state tax.  Thus, our
  607. taxable yield of 7.5% is reduced to 5.175% because of federal tax
  608. and to 4.5% when we add in state tax.  This means that the two
  609. investments are hardly equivalent.  Once taxes are factored in, the
  610. tax-free investment pays 1.5% more than the taxable investment.
  611.  
  612.      Function 7.2 turns this problem around by levelling the
  613. playing field in the opposite direction.  It approaches the problem
  614. by asking what the taxable equivalent of a tax-free yield is.  In
  615. the problem described above, the value of our 6% tax-free yield is
  616. increased by the combined federal and state tax obligation.  We
  617. would have to have a taxable yield greater than 8.695% to offset
  618. the effects of federal tax; the return would have to equal or
  619. exceed 10% to offset the combined effects of a 31% federal tax and
  620. 9% state tax.
  621.  
  622.      Function 7.3 simply answers the question of how many days have
  623. elapsed between two dates.  This routine takes into consideration
  624. leap years.
  625.     
  626.  
  627. Programming Considerations:
  628.  
  629.      "Your Financial Partner" was written in Borland C++ 3.1.  The
  630. menus and data entry screens were adapted from the Object
  631. Professional C++ Library from Turbo Power Software.  To ensure
  632. accuracy, all financial calculations were performed in BCD
  633. (financial) arithmetic and follow banker's rules of rounding.  Even
  634. so, there will be differences between results obtained using
  635. Financial Partner, spreadsheets, and other financial analysis
  636. programs.  Where comparable routines exist, "Your Financial
  637. Partner" has been thoroughly tested with examples from major
  638. financial analysis textbooks and its results accurate, to within
  639. limits of roundoff error, with Quattro Pro 4.0, Excel 3.0, HP 10B
  640. and 12 calculators, and the published textbook answers.      
  641.  
  642.      I sincerely hope that "Your Financial Partner" is useful to
  643. you.  I spent a great deal of time trying to write a program that
  644. I could use.  While I've tested all of the functions with a wide
  645. variety of data from financial analysis text and am convinced that
  646. all egregious bugs have been exterminated, I've been programming
  647. for long enough to know that bugs cannot ever be completely
  648. eradicated.  If you run into any problem, encounter any results
  649. that do not look right or that you know are incorrect, please drop
  650. me a note and explain the circumstances.  I do not want a "buggy"
  651. program circulating.
  652.  
  653. Legal Matters:
  654.  
  655.      My legal advisors tell me that I cannot warrant this program,
  656. expressly or by implication.  So there is no warranty attached to
  657. "Your Financial Partner."  You'll just have to take my word that it
  658. does do financial calculations, and as far as I can figure it
  659. mostly gives correct answers.  This generally means that I am not
  660. responsible if this program ruins your life.  On the other hand, if
  661. it makes you a millionaire, I'd like to know about it.
  662.  
  663. Money and Other Matters:
  664.  
  665.      As I indicated at the beginning of this manual, "Your
  666. Financial Partner" is distributed as "Shareware" on the honor
  667. system.  If, after using this program for 30 days, you find it
  668. valuable, please register the program by filling out the form below
  669. and send it to me along with a check for $39.95 to complete the
  670. registration process.  Registered users will receive the latest
  671. version of "Your Financial Partner" (devoid of the annoying
  672. "Shareware" screen), free upgrades for 6 months following
  673. registration, will be able to receive upgrades thereafter at a
  674. nominal fee, and are eligible for telephone support if needed.
  675.  
  676. Customer Service:
  677.  
  678.      Users needing help with "Your Financial Partner", users
  679. wishing to report a bug, users wishing to lavish me with praise, or
  680. users wanting to carp may contact me in writing at the address
  681. below (see Registration Form), or electronically via CompuServe
  682. (71212,2327), Internet (h1mf@odin.cc.pdx.edu), or BITNET
  683. (H1MF@PSUORVM.BITNET).  If you have an urgent problem, you may
  684. phone me at 503-725-3910 (this is in the Pacific Time Zone);
  685. however, this is my office phone number and I may or may not be
  686. able to talk with you when you call.  If you get my voice mail
  687. instead of me, please leave me a detailed message detailing
  688. precisely what you need.  Also indicate whether you are a
  689. registered user.  I cannot afford to provide telephone support to
  690. unregistered users (I will respond to any and all electronic mail
  691. or US Mail messages whether you are registered or not).  Include in
  692. your phone message a time of day where I will be able to get a hold
  693. you by phone.  I will try to respond as soon as possible. 
  694.  
  695. Acknowledgements:
  696.  
  697.      Thanks are due to my wife, Susan Wolf, and our children, Sarah
  698. and Elisabeth, for enduring the many months that writing this
  699. program consumed.  I also want to thank Ken at Tech Mate for all
  700. his helpful advice on using Object Pro C++.  My gratitude goes out
  701. to all the beta testers, and users of previous versions of "Your
  702. Financial Partner" for suggestions and encouragement, not to
  703. mention drawing noxious bugs to my attention.  
  704.  
  705. Things In The Planning Stages:
  706.  
  707.      Future versions of "Your Financial Partner" are already in the
  708. planning stages.  Proposed additions include (1) a simple, popup
  709. four-function calculator that will allow users to paste results
  710. into data fields; (2) loan qualification function; (3) stock
  711. valuation; (4) life expectancy calculations; and (5) inflation-
  712. adjustment option in various routines.  I welcome user suggestions. 
  713.  
  714. Useful Financial References:
  715.  
  716. The following proved invaluable to me in developing "Your Financial
  717. Partner."  I recommend them to anyone wishing to do further
  718. research.
  719.  
  720. Eugene F. Brigham, 1992, Fundamentals of Financial Management, 6th
  721. Edition.  San Diego:  Dryden Press (Harcourt, Brace, Jovanovich).
  722.  
  723. Petr Zima and Robert L. Brown, 1984, Contemporary Mathematics of
  724. Finance (Schaum's Outline Series).  New York:  McGraw Hill.
  725.  
  726. Registration Form:
  727.  
  728.                      Your Financial Partner
  729.                          Version 3.0CPP
  730.  
  731.                     
  732. Date_____________
  733.  
  734. Name__________________________________________________________
  735.  
  736. Address_______________________________________________________
  737.  
  738. City________________________________ State_________Zip________
  739.  
  740. Phone______________________
  741.  
  742. Where/how obtained_____________________________________________
  743.  
  744.  
  745. Please return this form with a check for $39.95 to:
  746.  
  747.                       Dr. Marc R. Feldesman
  748.                        Flying Pig Software
  749.                         4210 SW Comus St
  750.                    Portland, Oregon 97219-9504
  751.  
  752.  
  753.  
  754.